Über den Metadatenexport

Hier geht es zur Schnittstellen-Übersicht [Dokumentation der API]

Diese Schnittstellen bieten wir an: 

Neben unserer Suche nach Umwelt- und Naturschutzinformationen bieten wir an, die Metadaten der Datensätze über unsere Anwendungsschnittstelle abzurufen. Dies wird zusätzlich zum Export in unserem Metadatenschema über verschiedene Schnittstellen nach etablierten Standards möglich sein. Da es derzeit verschiedene Standards für die Übertragung von Metadaten gibt, haben wir als zukünftige Nutzende unsere Netzwerkpartner aus Zivilgesellschaft, Wissenschaft und Verwaltung im September 2024 gefragt, welche Standards sie bevorzugen. Ergebnis der Umfrage war, dass Nutzende vor allem die Standards CKAN, DCAT-AP, schema.org, CSW oder Dublin Core bevorzugen. Ab sofort bieten wir zunächst den Export per CKAN an, später sollen schema.org und weitere folgen.

CKAN

Damit Metadaten automatisiert weiterverarbeitet werden können, bietet umwelt.info etablierte Standards an. Dabei kann es durch die vorgenommene Standardisierung möglicherweise zu Verlusten kommen. So lässt der Standard CKAN etwa nur die Nennung eines einzelnen Autors beziehungsweise Herausgebers zu, während unser internes Schema mehrere Einträge in diesem Feld ermöglicht. 

Damit Daten, für die es keine eineindeutige Zuordnung gibt, trotzdem verfügbar sind, nutzen wir für diese das im CKAN-Standard vorgesehene Feld „Extras“, welches eine beliebige Zahl von frei definierbaren Einträgen zulässt. Dabei folgen wir weitestgehend der Nutzung dieses Feldes durch den CKAN-Export der Metadaten von govdata.org.

Unser CKAN-kompatibles Metadatenschema ist hier dokumentiert. Die Konvertierung unseres internen Schemas in diese Format kann am besten im Quellcode nachvollzogen werden.

Bei umwelt.info bieten wir zwei Endpunkte der API an: 

• package_search erlaubt das Ausführen einer Suche und antwortet mit den Inhalten der zum Suchergebnis passenden Datensätze. Die Suche mit einer Wildcard "*" ermöglicht die Abfrage des gesamten Metadatenbestandes auf umwelt.info.
• package_show ermöglicht die Abfrage einzelner Datensätze im CKAN Format. 

Warum halten wir es für wichtig, standardisierte Metadaten zum Export anzubieten? 

Das Portal umwelt.info speichert die Metadaten in einem internen Standard, der möglichst vollständig und flexibel semantische Informationen der Daten abbildet. Die Metadaten können selbstverständlich in diesem Schema über die API nachgenutzt werden. Da dieses jedoch nach Bedarf von uns immer wieder angepasst wird, können wir auch keine stabile API im internen Metadatenschema anbieten.

Um jedoch auch einen Export der Daten in einem stabilen und etablierten Standard zu ermöglichen, bietet umwelt.info auch einen Metadatenexport nach etablierten Standards an. Dadurch bietet umwelt.info nun auch die Möglichkeit, Metadaten, welche aus unterschiedlichen Quellen mit unterschiedlichen Schnittstellen stammen, in einem gemeinsamen Standard zu vergleichen.